PrStlDialog

Process user interaction for "Page Setup...

#include <PrintTraps.h> Printing Manager

THPrint hPrtRec ; handle leading to a TPrint structure

returns Did user choose OK in the dialog?

PrStlDialog processes a standard dialog to obtain such information as the

size and orientation ( the "style") to be used in subsequent printing of pages.

Call this function when the user selects "Page Setup..." from your "File" menu.

hPrtRec is a handle leading to a 120-byte TPrint structure. If the return

value is TRUE, the TPrint fields have been set as requested by the

user and the user has selected the OK button.

Returns: a Boolean; it indicates whether the user has approved the contents of

hPrtRec as reflected in the dialog. It is one of:

FALSE The user selected Cancel; no fields were changed.

TRUE The user selected OK and the print record is valid.

Notes: The values displayed in the dialog are taken from the most recently-used

print record. They do not necessarily reflect the values in hPrtRec.

Aside from creating your own "Page Setup..." dialog, there is no clean way

to pre-set options for the user. PrStlDialog keeps track of its current

defaults internally, changing them only when the user presses OK.

Upon return from this call, you may wish to examine the following fields

of hPrtRec to help you paginate and format the document:

prInfo.iVRes Printer vertical resolution in dots per inch

prInfo.iHRes Printer horizontal resolution in dots per inch

prInfo.rPage Boundaries of the printable page; topLeft is (0,0); bottom is

height, right is width

rPaper Size of the paper (same coordinate system as prInfo.rPage; top

and left are usually less than 0)

prStl.wDev High byte is device (1=ImageWriter, 3=LaserWriter,

0= screen)

For instance, you can calculate the height of the printing area, in inches,

by dividing the vertical resolution (iVRes) by the height of the page

(rPage.bottom - rPage.top).

Remember that PrOpen must be called prior to this or any other Printing

Manager calls.

Use PrJobDialog to let the user set job-specific fields such as the

number of copies desired and the number of pages to print.

Referenced by (35):